package com.tianji.promotion.service;

import com.tianji.api.dto.promotion.CouponDiscountDTO;
import com.tianji.api.dto.promotion.OrderCouponDTO;
import com.tianji.api.dto.promotion.OrderCourseDTO;
import com.tianji.common.domain.dto.PageDTO;

import com.tianji.promotion.entity.dto.UserCouponDTO;
import com.tianji.promotion.entity.po.Coupon;
import com.tianji.promotion.entity.po.UserCoupon;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.promotion.entity.query.UserCouponQuery;
import com.tianji.promotion.entity.vo.CouponVO;

import java.util.List;

/**
 * <p>
 * 用户领取优惠券的记录，是真正使用的优惠券信息 服务类
 * </p>
 *
 * @author lemon
 */
public interface IUserCouponService extends IService<UserCoupon> {


    /**
     * 领取优惠券
     *
     * @param couponId
     */
    void receiveCoupon(Long couponId);

    /**
     * 我的优惠券列表-分页查询-用户端
     *
     * @param query
     * @return
     */
    PageDTO<CouponVO> queryMyCouponPage(UserCouponQuery query);

    /**
     * 兑换码兑换优惠券
     *
     * @param code
     */
    void exchangeCoupon(String code);


    /**
     * 校验并生成用户券
     *
     * @param coupon
     * @param userId
     * @param serialNum
     */
    void checkAndCreateUserCoupon(Coupon coupon, Long userId, Integer serialNum);

    /**
     * 生成用户券-消费者
     *
     * @param dto
     */
    void checkAndCreateUserCouponNew(UserCouponDTO dto);

    /**
     * 查询我的优惠券可用方案--第三方接口
     *
     * @param orderCourses
     * @return
     */
    List<CouponDiscountDTO> findDiscountSolution(List<OrderCourseDTO> orderCourses);

    /**
     * 分页查询我的优惠券接口
     *
     * @param userCouponIds
     * @return
     */
    List<String> queryDiscountRules(List<Long> userCouponIds);


    /**
     * 根据券方案计算订单优惠明细
     *
     * @param orderCouponDTO
     * @return
     */
    CouponDiscountDTO queryDiscountDetailByOrder(OrderCouponDTO orderCouponDTO);


    /**
     * 核销优惠券
     *
     * @param userCouponIds
     */
    void writeOffCoupon(List<Long> userCouponIds);

    /**
     * 退还指定优惠券
     *
     * @param userCouponIds
     */
    void refundCoupon(List<Long> userCouponIds);
}
